

    \filetitle{highlight}{Highlight specified range or date range in a graph}{grfun/highlight}

	\paragraph{Syntax}

\begin{verbatim}
[Pt,Cp] = highlight(Range,...)
[Pt,Cp] = highlight(Ax,Range,...)
\end{verbatim}

\paragraph{Input arguments}

\begin{itemize}
\item
  \texttt{Range} {[} numeric {]} - X-axis range or date range that will
  be highlighted.
\item
  \texttt{Ax} {[} numeric {]} - Handle(s) to axes object(s) in which the
  highlight will be made.
\end{itemize}

\paragraph{Output arguments}

\begin{itemize}
\item
  \texttt{Pt} {[} numeric {]} - Handle to the highlighted area (patch
  object).
\item
  \texttt{Cp} {[} numeric {]} - Handle to the caption (text object).
\end{itemize}

\paragraph{Options}

\begin{itemize}
\item
  \texttt{\textquotesingle{}caption=\textquotesingle{}} {[} char {]} -
  Annotate the highlighted area with a text string.
\item
  \texttt{\textquotesingle{}color=\textquotesingle{}} {[} numeric
  \textbar{} \emph{\texttt{0.8}} {]} - An RGB color code, a Matlab color
  name, or a scalar shade of gray.
\item
  \texttt{\textquotesingle{}excludeFromLegend=\textquotesingle{}} {[}
  \emph{\texttt{true}} \textbar{} \texttt{false} {]} - Exclude the
  highlighted area from legend.
\item
  \texttt{\textquotesingle{}hPosition=\textquotesingle{}} {[} `center'
  \textbar{} `left' \textbar{} \emph{`right'} {]} - Horizontal position
  of the caption.
\item
  \texttt{\textquotesingle{}vPosition=\textquotesingle{}} {[} `bottom'
  \textbar{} `middle' \textbar{} \emph{`top'} \textbar{} numeric {]} -
  Vertical position of the caption.
\end{itemize}

\paragraph{Description}

\paragraph{Example}


